home *** CD-ROM | disk | FTP | other *** search
/ FM Towns: Free Software Collection 6 / FM Towns Free Software Collection 6.iso / t_os / lc / lc.doc next >
Text File  |  1993-07-08  |  5KB  |  99 lines

  1. ==============================================================================
  2. 【ソフト名 】  LC V1.0 for TOWNS-OS/MS-DOS                     DATE. 1993.3.2
  3. 【ファイル名】  LC.EXP  C言語コメント率カウントTOOL(ネイティブ版)
  4.                 LC.EXE  C言語コメント率カウントTOOL(リアル版)
  5.                 LC.DOC  ドキュメント ファイル
  6.                 LC.GGG  概要 ファイル
  7. 【著作権者  】  あーうー  NIFTY-ID(HGE02015)
  8. 【動作確認  】  FM-TOWNS 20F TOWNS-OS V2.1 L10 / FMR-50LT MS-DOS V3.1
  9. 【動作環境  】  2M RAM(確認はしてませんがたぶん1Mでも動くと思います)
  10. 【配付条件  】  特にありませんが、事前にメール下さい。
  11. 【開発言語  】  HIGH-C/MS-C 
  12. ==============================================================================
  13. 【機能   】 Cソースファイル(".c") 及びヘッダファイル(".h")について以下の情報を出力しま
  14.               す。
  15.           ・総ステップ数 ・・・・・ コメントを含んだ全行数
  16.           ・実ステップ数 ・・・・・ コメントを含まない行数
  17.           ・コメント率    ・・・・・ (総ステップ数-実ステップ数)÷総ステップ数×100 
  18.  
  19.                 また、MS-DOSのワイルドカード(?,*)の指定が可能であり、複数のファイルが検
  20.               索されたときは、それらについての合計も表示します。このとき、".c"
  21.               及び".h"以外のファイルが検索された場合、表示はされますが合計には加算
  22.               しないようにしてあります。
  23.  
  24. 【使用方法 】 MS-DOSコンソール 上から次のように入力して下さい。実行後、結果が表示
  25.               されます。
  26.  
  27.                    LC  ファイル名  [-n]
  28.  
  29.               《ファイル名について》
  30.                   実ステップ数をカウントしたいCソースファイル またはヘッダファイル を指定します。
  31.                   また、ファイル名には、ドライブ名、パス名指定をすることができます。
  32.                   なお、MS-DOSのワイルドカード の指定も可能です。
  33.  
  34.               《-n オプションについて》
  35.                   本コマンド の実行結果には、エスケープシーケンスを用いて色を付け、見やすく
  36.                 しています。
  37.                   しかし、リダイレクト機能を用いて、結果をファイルにはきだす場合、かえっ
  38.                て見づらくなることがあります。
  39.                   そんなとき、-n オプションを指定して下さい。エスケープシーケンス を削除しま
  40.                 す。
  41.  
  42. 【備      考】《コメント行について》
  43.          本TOOLは、コメントとして、空行・//行・/*~*/行を判別して
  44.         います。
  45.  
  46.        《TOWNSコンソール上での実行について》
  47.          TOWNSコンソールからネイティブ版を実行させる場合、アイコン登録でMS-DOSモード
  48.                 にしておいて下さい。
  49.                  (TOWNS-OSモードだと実行結果が表示後、画面がクリアされます)。
  50.  
  51. 【使  用  例】
  52.  
  53.       使用例1  B:\>          LC E:\HC386\INC\FMCFRB.H
  54.  
  55.                  ファイル名 総ステップ数 実ステップ数 コメント率
  56.                  ---------------------------------------------------- 
  57.                   FMCFRB  .H           474           192         59%
  58.  
  59.       使用例2  E:\HC386\PGM> LC *.*
  60.  
  61.                   ファイル名 総ステップ数 実ステップ数 コメント率
  62.                  ---------------------------------------------------- 
  63.                   HC      .BAT          13 .............. no count
  64.                   LINK    .BAT           1 .............. no count
  65.                   RUN     .BAT           1 .............. no count
  66.                   LINKLIB .LNK           1 .............. no count
  67.                   CDVOL   .C           109            97         11%
  68.                   1       .C            44            27         38%
  69.                   2       .C            24            17         29%
  70.                   XXX     .DAT          18 .............. no count
  71.                   CDVOL   .OBJ          12 .............. no count
  72.                   CDVOL   .EXP          33 .............. no count
  73.                   LC      .C           300           252         16%
  74.                   LC      .OBJ           9 .............. no count
  75.                   LC      .EXP          45 .............. no count
  76.                  ---------------------------------------------------- 
  77.                   合計/平均           477           393         17%
  78.  
  79.                     注)no countと表示されたものについては、低輝度で表示され、
  80.               合計にはカウントされない。
  81.  
  82.       使用例3  E:\>          LC HC386\PGM\*.C
  83.  
  84.                   ファイル名 総ステップ数 実ステップ数 コメント率
  85.                  ---------------------------------------------------- 
  86.                   CDVOL   .C           109            97         11%
  87.                   1       .C            44            27         38%
  88.                   2       .C            24            17         29%
  89.                   LC      .C           300           252         16%
  90.                  ---------------------------------------------------- 
  91.                   合計/平均           477           393         17%
  92.  
  93.                     注)使用例2と使用例3の結果は同じとなる。
  94.  
  95. 【コメント 】  本TOOLは、C言語開発者を対象に作成しました。
  96.  
  97.         C言語で作成したプログラム としては、これが2本目となります。今回、       ネイティブ版とリアル 版を作成したのですが、MS-CとHigh-Cでint型のバイト 数
  98.               が異なるのを知らなくて苦労しました(^_^;
  99.